home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / netmail / wsomr120.zip / WS.DAT / WSOMR.DOC < prev    next >
Text File  |  1996-04-24  |  34KB  |  1,146 lines

  1.  
  2. ==========================================================================
  3. ^About wsOMR
  4. ░░░░░░░░░░░
  5.  
  6.   wsOMR is a small, fast, Internet/usenet/BBS offline mail/news reader.
  7.   It supports four major e-mail formats namely, Internet(RFC), SOUP,
  8.   Bluewave, QWK. It is the first and only OMR that supports Fido and
  9.   Internet at the same time, very handy for users who have access to
  10.   different networks as there is no need to learn different readers.
  11.  
  12.   With wsOMR you can read and reply to your favorite BBS,Internet,
  13.   USENET mail at your own leisure and manage larger volumes of mail with
  14.   relative ease, send/receive files over Internet.  It saves you from
  15.   the pressures of online-time charge, long distance calls, etc.
  16.  
  17.   Hardware requirements for wsOMR:
  18.  
  19.   An IBM PC, AT, 80386, 80486, or fully compatible personal
  20.   computer. A minimum of 560k of free memory.
  21.  
  22. ==========================================================================
  23. ^REGISTRATION
  24. ░░░░░░░░░░░░
  25.  
  26.   wsOMR is distributed as shareware. This means that you are granted
  27.   a limited license to use it for a period of 30 days. If you find
  28.   it useful and decide to continue using it after the trial period,
  29.   registration is required.
  30.  
  31.   To register, just fill up the registration form in REGFORM.TXT and
  32.   send to the address indicated in the file. A registration number
  33.   will be sent to you by either e-mail or ordinary mail afterwards.
  34.  
  35.   I would greatly appreciate your registration. It is your way of
  36.   encouraging me to continue developing the program.
  37.  
  38. ==========================================================================
  39. ^INSTALLATION:
  40. ░░░░░░░░░░░░░
  41.  
  42.   Create a temporary directory and unpack the wsomr120.zip in that
  43.   directory
  44.  
  45.   Run Install.exe from that directory.
  46.  
  47.   To install the program for Internet, please check the Internet
  48.   section for more detailed information.
  49.  
  50. ==========================================================================
  51. ^CONFIGURATION:
  52. ░░░░░░░░░░░░░░
  53.  
  54.   run wsomr, choose "Configuration" from the main menu.
  55.  
  56. ==========================================================================
  57. ^COMMAND LINE OPTIONS
  58. ░░░░░░░░░░░░░░░░░░░░
  59.  
  60.   to run the program with default .INI and Bluewave mail packet
  61.  
  62.   wsOMR
  63.  
  64.   Command line options:
  65.  
  66.   wsOMR [/q][/b][/s] [/iINI] [/?]
  67.  
  68.   /b   Read Bluewave packets (default)
  69.   /q   Read QWK packets
  70.   /i   Read RFC compliant Internet mail
  71.   /s   Read SOUP packets (for Internet)
  72.   /f   Use alternate ini file
  73.   /?   Display help screen
  74.  
  75. ==========================================================================
  76. ^USE wsOMR WITH BBS
  77. ░░░░░░░░░░░░░░░░░░
  78.  
  79.   For BBS, wsOMR reads mail packets in the two main formats, Bluewave
  80.   and QWK.  Please choose the appropriate command line switch for the
  81.   format in your bbs. Following instruction assumes you are using QWK
  82.   format.
  83.  
  84.   1. Installation
  85.   ================
  86.  
  87.   1.1 run wsOMR /q
  88.   1.2 choose "New Host"
  89.   1.3 enter BBS ID, the BBS ID is the file name without extension of the
  90.       packets you downloaded, e.g: if your packets are using MYBBS.Q01,
  91.       MYBBS.Q02 then the BBS ID is MYBBS.
  92.  
  93.   2. Downloading of mails
  94.   =======================
  95.  
  96.   This depends on the bbs you are accessing, check with your sysop about
  97.   this.
  98.  
  99.   3. Reading/Answering of mails
  100.   =============================
  101.  
  102.   3.1 run wsomr /q
  103.   3.2 choose "Open Host" and select a bbs from the pick-list.
  104.   3.3 Open an existing packet, read/answer it according to the
  105.       instruction of the reader.
  106.   3.4 Upon exit, wsomr will create a reply packet in the upload
  107.       directory ready to be uploaded to your bbs, e.g. MYBBS.REP, for
  108.       Bluewave it will be MYBBS.NEW
  109.  
  110.   4. Uploading of mails
  111.   =====================
  112.  
  113.   This is done thru the mail doors in the bbs, check with your sysop
  114.   about this.
  115.  
  116. ==========================================================================
  117. ^USE wsOMR WITH INTERNET
  118. ░░░░░░░░░░░░░░░░░░░░░░░
  119.  
  120.   wsOMR provides two kinds of Internet support, namely:
  121.  
  122.   1. Internet ( RFC message level)
  123.   2. SOUP     ( packet level, please refer to the USENET section )
  124.  
  125.   Assuming that you are not into USENET reading/posting, the first
  126.   option is more than likely the best choice for you. Why? It is easier
  127.   than the SOUP option since it does not require any other software to
  128.   be installed on your Internet host except the very simple wsmail.c
  129.   file.
  130.  
  131.   ==========================================================================
  132. ^USE wsOMR WITH INTERNET (RFC MESSAGE LEVEL)
  133.  
  134.   1. Installation
  135.   ================
  136.  
  137.   1.1  Upload wsmail.c to your Internet host.
  138.   1.2  While logged in to your host type "cc wsmail.c"
  139.   1.3  Next, type "mv a.out wsmail"
  140.  
  141.   Note:
  142.  
  143.   wsmail.c is only for use by the Unix compiler, don't try to update it
  144.   and save it again in MS-DOS otherwise it will not be compiled by Unix
  145.   C compiler. It is important therefore, to keep wsmail.c as is!
  146.  
  147.   In some Linux systems, smail is used instead of sendmail, please
  148.   change the following line in wsmail.c
  149.  
  150.   FROM:
  151.     char *send_cmd  = "sendmail -t ";   /* change this in case different */
  152.   TO:
  153.     char *send_cmd  = "smail -t ";      /* change this in case different */
  154.  
  155.   There are times that the sendmail is not in a directory specified in
  156.   the Unix path, just issue "whereis sendmail" or "whereis smail" in 
  157.   your ISP machine and take note of the complete path name of the 
  158.   sendmail command in your Unix host, update the above line accordingly.
  159.  
  160.  
  161.   2. Uploading of mails
  162.   =====================
  163.  
  164.   2.1. Run wsOMR /i
  165.   2.2. If this is your first time accessing Internet, choose "New Host"
  166.        from the main menu and enter a name you like, example: INTERNET.
  167.        else choose "Open Host" and pick a name from the pick list.
  168.   2.3. Enter messages (there is only one area available).
  169.   2.4. After each session, wsOMR will create a new file called "???.txt"
  170.        [???=the name of your BBS].
  171.   2.5. Upload the ???.txt  file to your Internet host.
  172.   2.6. Run wsmail by typing "wsmail r ???.txt.
  173.   2.7. wsmail will confirm that your messages are sent.
  174.  
  175.   Note: to make sure your message will not be posted multiple times,
  176.         use: wsmail r- ???.txt The minus sign(-) tell wsmail to delete
  177.         the file after posting.
  178.  
  179.   3. Downloading of mails
  180.   =======================
  181.  
  182.   3.1. Log in to the Internet host.
  183.   3.2. Pack your mail into a file by typing:
  184.        wsmail m ???.001 [???=the name of your BBS]
  185.        Note: If you wish, you can use the "mailx" command instead.
  186.   3.4. Download ???.001 to your PC by typing "sz ???.001"
  187.   3.5. Log off from the Internet host.
  188.   3.6. Start wsOMR by typing " wsomr /i"
  189.   3.6. Open the ???.001 file.
  190.   3.7. read/answer the mail
  191.   3.8. upon exit, ???.001 will be zipped.
  192.  
  193.   ==========================================================================
  194. ^USE wsOMR WITH USENET (SOUP, Simple Offline USENET Packet Format)
  195.  
  196.   wsOMR is fully compatible with SOUP specifications ver 1.2. wsOMR is a
  197.   SOUP reader as well as being a BW/QWK/Internet reader. SOUP is usually
  198.   used for USENET reading/posting as well as e-mailing.
  199.  
  200.   1. Installation
  201.   ================
  202.  
  203.   Make sure that UQWK, ZIP and UNZIP are installed in your Internet
  204.   host.  Ask your system administrator about it.
  205.  
  206.   2. Downloading of mails/news
  207.   ============================
  208.  
  209.   2.1 While logged in to the Internet type "uqwk +L +n"
  210.   2.2 type "zip soup.001 00* AREAS"
  211.   2.3 download the zipped file by typing "sz soup.001"
  212.  
  213.   3. Uploading of mails/news
  214.   ==========================
  215.  
  216.   3.1 While logged in to the Internet type "rz soup.rep" and start your
  217.       comm program to upload the soup.rep from your PC to home
  218.       directory.
  219.   3.2 Type "unzip -U soup.rep"
  220.   3.3 Type "uqwk +L -RREPLIES"
  221.  
  222.   4. Reading/Replying mails/news
  223.   ==============================
  224.   4.1 Start wsomr by typing  "wsomr /s"
  225.   4.2 Open a packet and read/reply, upon exit a reply packet will be
  226.       created.
  227.  
  228. ==========================================================================
  229. ^Mailing List Grouping
  230. ░░░░░░░░░░░░░░░░░░░░░
  231.  
  232.  For easy viewing of messages, wsOMR groups incoming messages according
  233.  to certain conditions in the header. (From what I know, wsOMR is the
  234.  first reader with this innovative feature)
  235.  
  236.   1. Auto Grouping.
  237.  
  238.      wsOMR automatically detects messages from various mailing lists
  239.      and places them together in the respective groups.
  240.  
  241.   2. Undigestifying.
  242.  
  243.   3. Unlogging of Monthly archive
  244.  
  245.   4. User defined group (UDG)
  246.       please refer to groups.ini for details.
  247.  
  248.   Note:
  249.     All the above features have been tested against thousands of
  250.     messages from the major mailing list programs, such as: Listserv,
  251.     Listproc, Majordomo, Maiser, Smartlist, Mreply, GIGO and some
  252.     others. (for SOUP/RFC)
  253.  
  254. ==========================================================================
  255. ^EXTERNAL TAGLINE MANAGERS
  256. ░░░░░░░░░░░░░░░░░░░░░░░░░
  257.  
  258.  There are two ways to define an external tagline manager, TagXpro and
  259.  Cherry Picker are used here as sample managers, please check with your
  260.  favorite tagline manager's documentation for specific instructions:
  261.  
  262.   1. Thru wsOMR external tagline manager hook
  263.  
  264.       tagline_mgr=c:\tagx\tagx.exe //bc t @f
  265.  
  266.       If your tagline manager is John Hancock compatible, just omit
  267.       the @f in the command line:
  268.  
  269.       tagline_mgr=c:\cp\cp.exe c:\cp\tag.var
  270.  
  271.   2. Via wsOMR's tagline file, wsomr.tag
  272.  
  273.       The methods described in the #1 can also be used to specify
  274.       unlimited number of tagline managers by placing the command
  275.       in the wsomr.tag, just prefix every command with
  276.       [EXTERNAL, Manager desc], example:
  277.  
  278.       [External, TagXpro]c:\tagx\tagx.exe //bc t @f
  279.       [External, Cherry Picker]c:\cp\cp.exe c:\cp\tag.var
  280.  
  281.       Please check wsomr.tag for some samples.
  282.  
  283.   3. Via editor command
  284.  
  285.       editor=C:\TAGX\TAGX.exe //BC f @f
  286.       Disable_Tagline=YES
  287.  
  288.   Note: if John Hancock compatible tagline is used, all the wsOMR type
  289.         macros(@name. for example) are still applicable.
  290.  
  291. ==========================================================================
  292. ^SIGNATURE FILE
  293. ░░░░░░░░░░░░░░
  294.  
  295.   The signature file is a pure text file containing one or more
  296.   signatures. if more than one signature is defined, a pick list
  297.   will pop up during the entry of new messages for the user to select
  298.   one of the appropriate signatures. "+" is used to separate
  299.   signatures, example:
  300.  
  301.   Frank (wang@durian.usc.edu.ph)
  302.   +
  303.   F.Wang
  304.   E-mail: wang@durian.usc.edu.ph
  305.   Fido  : 6:754/10.20
  306.  
  307.   Optionally the signature file could also be used as a multiple-line
  308.   tagline file.
  309.  
  310. ^Note:
  311.  
  312.   1.Just like tagline, you can use wsOMR's macro in a signature
  313.     file, this will cause some problem if your e-mail address is
  314.     part of the file, for example:
  315.  
  316.    ^wang@durian.usc.edu.ph^ will become
  317.  
  318.    ^wangdurian.usc.edu.ph^.  To solve this problem, prefix any "@"
  319.     that is not part of marco with ^"\",
  320.  
  321.    ^wang\@durian.usc.edu.ph
  322.  
  323.   2. By default, wsOMR uses signature file defined in wsomr.ini for
  324.      Internet/usenet messages only. However it respects the entry
  325.      "Signature" in the format.ini, this option will enable you to use
  326.      different signature files in different levels, please refer to
  327.     ^format.ini.^
  328.  
  329. ==========================================================================
  330. ^MAILING LIST
  331. ░░░░░░░░░░░░
  332.  
  333.   wsOMR provides a convenient mailing list support in the reader level,
  334.  
  335.   Mailing list support(MLS):
  336.  
  337.   WSOMR's MLS lets you deliver mail to a group of internet addresses
  338.   conveniently.  The important point is that you send one piece of mail
  339.   and wsmail automatically sends copies to everyone listed in the MLS
  340.   file.
  341.  
  342.   How would an MLS work?
  343.  
  344.   As an example, lets assume that a small group of family members
  345.   consisting of a father, his daughter and his son all listed in a MLS
  346.   file called FAMILY.MLS, in the address book an #c:\FAMILY.MLS is
  347.   defined The father would send a message using the #c:\family.mls in
  348.   the address field and copies would immediately go to his daughter and
  349.   to his son.  His son could send a response using the same MLS file and
  350.   his father and sister would get copies of the response.
  351.  
  352.   How to create a MLS  file?
  353.  
  354.   MLS file is a simple text file, each line contains one address, you
  355.   can also put comments in the same line, any thing to the right of
  356.   // are considered comments and will be ignored, example:
  357.  
  358.   wang@durian.usc.edu.ph      // author
  359.   umm@alfa.ist.utl.pt     // Tiago Pascoal
  360.   restrada@durian.usc.edu.ph  // user
  361.   kira@jolt.ipx.com           // review & FAQ author
  362.  
  363.   Put all those lines into a file name sample.mls and in your address
  364.   book, you create an entry:
  365.  
  366.   Friends list              $#c:\sample.mls, that's all.
  367.  
  368.   during the input, just press F9 to pop up the list and select
  369.   Friends list.
  370.  
  371. ==========================================================================
  372. ^MAJOR FEATURES:
  373. ░░░░░░░░░░░░░░░
  374.  
  375.   Features unique to FIDO/BBS
  376.  
  377.   + Easy file request, can use editor or cut & paste from new files list.
  378.   - Simple offline area configuration.
  379.   - Fully compatible with Bwave.exe.
  380.   + Martin Pollard's Offline Mail Executive aware.
  381.   - Superior Internet/Netmail support in FIDO mode
  382.     no more UUCP and "To:" line required.
  383.   + Bluewave style netmailing for QWK-based packet.
  384.   + Retrieve fido address from origin line in netmail resulting in
  385.     no more mistakes in making netmail-reply to echomail/netmail messages
  386.     which is a solution to Bluewave's problem in replying to point-netmail.
  387.  
  388.   Features unique to Internet/SOUP
  389.  
  390.   + Intelligent processing of mailing list generated messages, accurate up
  391.     to 98%, messages grouped by mailing list title.
  392.   + Fully Listserv, Listproc, Majordomo generated message aware.
  393.   + Undigestifying digest messages/log files of Listserv, Majordomo
  394.     and Listproc
  395.   + Sending/receiving of files over internet(MIME encoding/decoding )
  396.   + Reader level mailing list service (you can maintain a mailing list w/o
  397.     the need of a mailing list server)
  398.  
  399.   Features general to Internet/BBS
  400.  
  401.   - Reads Internet(RFC822)/SOUP/Bluewave/QWK mails.
  402.   - Handles unlimited number of BBSes.
  403.   + Replies for multiple packets can be entered at one time.
  404.   + Point & shoot Address book with Fido & Internet addresses.
  405.   + Point & shoot capturing of Fido/Internet address from message.
  406.   + Fido to Internet address format conversion.
  407.   + Databased reply folder for Internet/Fido.
  408.   - UUDECODE/MIME DECODE messages.
  409.   + Multiple mail packets can be opened at the same time.
  410.   - On line smile symbols & acronyms.
  411.   - On line context sensitive help.
  412.   - Commands which work together with several popular spell checkers.
  413.   + Easy configuration within a Windows style INI file.
  414.   - Tagline stealing.
  415.   - Well planned user interface which reduces your keystroke to a minimum.
  416.   - Small & fast.
  417.   - Runs well under Windows 3.x, Windows 95, OS/2.
  418.   + PGP shell       ( under development )
  419.   - FAX support     ( under development )
  420.   + Japanese DOS/V  ( under development )
  421.   - others to be listed later
  422.  
  423.   + Indicates features not found in other readers.
  424. ==========================================================================
  425. ^Tech. specification
  426. ░░░░░░░░░░░░░░░░░░░░
  427.  
  428.   1. Maximun number of messages
  429.       1.1 SOUP
  430.             2000 per area
  431.       1.2 RFC
  432.             2000 per packet
  433.       1.3 Bluewave
  434.       1.4 QWK
  435.  
  436. ==========================================================================
  437. ^Macro
  438. ░░░░░
  439.  
  440.   wsOMR provides a macro facility for users to customize reply layout.
  441.  
  442. 1. Configurable reply format and taglines:
  443. ==========================================
  444.  
  445. 1.1 Format strings in .INI
  446.  
  447. Hello              : String to start a new message with.
  448. Reply              : String to start a reply with. This is usually
  449.                      something like: 'In a message xxx wrote to yyy'.
  450. Reply_4_usenet     : Same as Reply but used when posting news in USENET.
  451. Signoff_Fido       : String to be placed at the end of every message.
  452. Signoff_Internet   : String to be placed at the end of every message.
  453. Expandable Tagline : Tagline that contains embedded macros.
  454. Signature file     : Entries in the sigfile can contain embedded macros.
  455.  
  456. 1.2 A new message/news has the form of :
  457.  
  458.   @Hello.,
  459.  
  460.   Body of message
  461.  
  462.   @Signoff.
  463.  
  464. 1.3 A reply message has the form of :
  465.  
  466.   @Reply.,
  467.  
  468.   Body of message
  469.  
  470.   @Signoff.
  471.  
  472. 1.4 A reply news has the form of :
  473.  
  474.   @Reply_4_usenet.,
  475.  
  476.   Body of message
  477.  
  478.   @Signoff.
  479.  
  480. 1.5 A forwarded message has the form of:
  481.  
  482.   @fwd_start.
  483.   @fwd_date.
  484.   @fwd_from.
  485.   @fwd_to.
  486.   @fwd_subj.
  487.   Body of message
  488.   @fwd_end.
  489.   @Signoff.
  490.  
  491. Note:
  492.  
  493.   Max. length of hello and reply string is 80 characters, and the max.
  494.   expandable length is 1024.
  495.  
  496. 2. Macros used in Hello, Reply strings and expandable taglines
  497. ===============================================================
  498.  
  499. 2.1 Format of macro
  500.  
  501.  Macro should be started with "@" and ended with ".", anything between
  502.  will be considered as an identifier and will not be expanded in the
  503.  result string.
  504.  
  505.  If "@" is used as an ordinary character instead of a macro symbol, it
  506.  should be prefixed with an escape character "\", e.g.:
  507.  wang\@durian.usc.edu.ph, the result string will be
  508.  wang@durian.usc.edu.ph
  509.  
  510. 2.2 Predefined macros
  511.  
  512.  @n.        :   new line.
  513.  @t.        :   tab( 8 spaces).
  514.  @bbs_id.   :   Host name.
  515.  @name.     :   your complete name.
  516.  @first.    :   your first name.
  517.  @last.     :   your last name.
  518.  @fido.     :   your fido address.
  519.  @internet. :   your internet address, if empty and you have fido address,
  520.                 fido address will be converted to internet address.
  521.  @WWW.      :   your worldwide web URL.
  522.  @date.     :   local date
  523.  @time.     :   local time in the form of hh:mm:ss
  524.  @place.    :   City name
  525.  @omr.      :   name & version of OMR used
  526.  @os.       :   Operating system running in your computer.
  527.  @bar??.    :   Returns a line of ?? '-', examples:
  528.                 @bar79., @bar21., @bar02.
  529.  
  530.  @quote.    :   A random quote taken from tagline file. be sure it is truly
  531.                 random, what you see might not be the line chosen:)
  532.  @mFname.   :   Complete "From" name in the incoming message.
  533.  @mFfirst.  :   First name of "From".
  534.  @mFlast.   :   Last name of "From".
  535.  @mFinitial :   Initial of "From".
  536.  @mTname.   :   Complete "To" name in the incoming message.
  537.  @mTfirst.  :   First name of "To".
  538.  @mTlast.   :   Last name of "To".
  539.  @mTinitial :   Initial of "To".
  540.  
  541.  @mSubj.    :   subject in the incoming message.
  542.  @mDate.    :   Date and time in the incoming message.
  543.  
  544.  @rFname.   :   Complete "From" name in the reply you are making(outgoing message)
  545.  @rFfirst.  :   First name of "From"
  546.  @rFlast.   :   Last name of "From"
  547.  @rTname.   :   Complete "To" name in the reply(outgoing message)
  548.  @rTfirst.  :   First name of "To"
  549.  @rTlast.   :   Last name of "To"
  550.  
  551.  // following macros are for Internet/usenet only
  552.  
  553.  @Message_ID. : message ID of the message
  554.  @author.   :   Author of the message including address( taken from from: line)
  555.  @iFrom.    :   Same as @author.
  556.  @iTo.      :   Addressee of the message including address( taken from To: line)
  557.  
  558.  Note: iFrom, iTo will be the same as @from and @to in QWK/BW mode.
  559.  
  560. 3. Some examples to clear up things
  561. ===================================
  562.  
  563. 3.1 New messages:
  564.  
  565. Let's say I'm writing a message to Rey Estrada, so that's a new message,
  566. and the 'Hello' keyword would be used here. The header would look like
  567. this:
  568.  
  569. From: Frank Wang
  570. To  : Rey Estrada
  571. Subj: your
  572.  
  573. Hello1=Hello @rFfirst.@n.,
  574. Signoff1=@n.@n.@first.@n.Fido:@fido.@n.@Internet.@n.@date.
  575.  
  576. My message would be started with:
  577.  
  578. Hello Rey,
  579.  
  580. Frank
  581. Fido:6:754/1.20
  582. Internet:wang@durian.usc.edu.ph
  583. Dec. 12, 1994
  584.  
  585. 3.2 Replying
  586.  
  587. Let's say I received a message from Rey Estrada, the header of the
  588. message looks like :
  589.  
  590. Date: Dec. 12. 1994
  591. From: Rey Estrada
  592. To  : Frank Wang
  593. Subj: My registration is on the way!
  594.  
  595. I'm going to reply to Rey, since this is a reply, the reply string will
  596. be used here:
  597.  
  598. Reply=On @mDate. @mFname.wrote to @mTname....@n.
  599. Signoff1=@n.@n.@first.@n.Fido:@fido.@n.@Internet.@n.@date.
  600.  
  601. The reply would start with:
  602.  
  603. On Dec. 12. 1994 Rey Estrada wrote to Frank Wang:
  604.  
  605.   >
  606.   >
  607.  
  608. Frank
  609. Fido:6:754/1.20
  610. Internet:wang@durian.usc.edu.ph
  611. Dec. 12, 1994
  612.  
  613.  
  614. ==========================================================================
  615. ^CONFIG
  616. ░░░░░░
  617.  
  618. This document briefly describes the keywords used in WSOMR.INI
  619.  
  620. WSOMR.INI is a plain ASCII file, it may contain keywords and comments.
  621. A comment is a line that starts with a semi-colon, like this:
  622.  
  623. ; this is a comment.
  624.  
  625. Blank lines are ignored, keyword line should be in the form of:
  626.  
  627. <keyword>=<value>
  628.  
  629. the equal sign should not be preceded nor followed by a space.
  630.  
  631. Example:
  632.  
  633. ; correct:
  634. DOWN_LOAD=d:\com\down
  635.  
  636. ; wrong
  637. DOWN_LOAD = d:\com\down
  638.  
  639. -------------------------------------------------------------------------
  640.  
  641. [REGISTRATION]
  642.  
  643. NAME=your name
  644. --------------
  645.  
  646.   your login name
  647.  
  648. REG_NUM=00000
  649. -------------
  650.  
  651.   reg'n number from Unisoft, Inc.
  652.  
  653. [INFO]
  654.  
  655. ALIAS1=ALL
  656. ALIAS2=
  657. ...
  658. ALIAS9=
  659. ----------
  660.  
  661.   Alternative names used in the scanning of personal mails, work for QWK
  662.   SOUP/INTERNET.
  663.   you can use "ALL" to scan messages addressed to all.
  664.  
  665. FIDO=8:888/8.88
  666. ---------------
  667.  
  668.   your fido address, leave it blank if none
  669.  
  670. INTERNET=wang@durian.usc.edu.ph
  671. -------------------------------
  672.  
  673.   your internet address, leave it blank if none
  674.  
  675. PLACE=Cebu, Phil.
  676. -----------------
  677.  
  678.   city, country, ex: Cebu, Phil.
  679.  
  680. ADDRESS_BOOK=c:\mybook.adr
  681. --------------------------
  682.  
  683.   address book for fido/internet, defaults to wsomr.adr in wsomr directory
  684.   if left blank.
  685.  
  686. SIGNATURE=c:\mysig.txt
  687. ----------------------
  688.  
  689.   Signature file to be appended at bottom of message(for Internet only)
  690.  
  691. [PATHS]
  692.  
  693. UP_LOAD=d:\com\upload
  694. ---------------------
  695.  
  696.   Directory containing files to be uploaded, this is usually the upload
  697.   directory of your communication program.
  698.  
  699. DOWN_LOAD=d:\com\down
  700. ---------------------
  701.  
  702.   Directory containing downloaded packets/files, same as UP_LOAD
  703.  
  704. FOLDER_DIR=c:\mail\folder
  705. -------------------------
  706.  
  707.   directory to store mail-sent folders.
  708.  
  709. FOLDER_INTERNET=default
  710. -----------------------
  711.  
  712.   name of folder(max 8 char.) for internet mail, if empty or default,
  713.   bbs_id will be used.
  714.  
  715. FOLDER_BBS=default
  716. ------------------
  717.  
  718.   name of folder(max 8 char.) for internet mail, if empty or default,
  719.   bbs_id will be used.
  720.  
  721. FOLDER_AUTO_SAVE=yes
  722. --------------------
  723.  
  724.   no prompt for confirmation before moving replies to folder.
  725.  
  726. EDITOR=c:\utl\qe\qe.exe
  727. -----------------------
  728.  
  729.   Editor, qedit works fine with wsOMR, an internal qedit-like editor is
  730.   being prepared for a future version.
  731.  
  732. SPELL_CHECKER=c:\spell\spell.exe
  733. --------------------------------
  734.  
  735.   Spell checker, leave it blank if no speller is used.
  736.  
  737. EXT_INTERNET=0* 1* 2* 3* 4* 5* w* p*
  738. EXT_QWK=q*
  739. EXT_BW=s* m* t* w* f* 0* 1* 2* 3* 4* 5*
  740. ---------------------------------------
  741.  
  742.   File extensions for Internet/SOUP, qwk and Bluewave packets.
  743.  
  744. [ARCHIVER]
  745.  
  746. DEFAULT=0
  747. ---------
  748.  
  749.   Archiver specified in bbs door:
  750.     0 - zip, 1 - arc, 2 - lzh, 3 - pak, 4 - arj, 5 - uc2, 6 - rar
  751.  
  752. ZIP=c:\prog\pkzip.exe
  753. UNZIP=c:\prog\pkunzip.exe
  754. ARC=c:\prog\arc.exe
  755. LZH=c:\prog\lha.exe
  756. PAK=c:\prog\pak.exe
  757. ARJ=c:\prog\arj.exe
  758. UC2=c:\prog\uc.exe
  759. RAR=c:\prog\rar.exe
  760. --------------------
  761.  
  762.   Pathnames for different archivers.
  763.  
  764. [FILES]
  765.  
  766. INCOMING_EXPORT_FILE=c:\mail\inmail\*.cab
  767. OUTGOING_EXPORT_FILE=c:\mail\outmail\*.cab
  768. ------------------------------------------
  769.  
  770.   File names for saving of outgoing/incoming mails, can use wildcard characters,
  771.   leave them blank if not necessary.
  772.  
  773. SAVED_RFC_TO=MONTH.*
  774. --------------------
  775.  
  776.   File name without path for the saving of Internet mails.
  777.  
  778. [MISC]
  779.  
  780. HELLO=Hello @rTfirst.,@n.
  781. -------------------------
  782.  
  783.   Greeting template for new message.
  784.  
  785. REPLY=Hello @mFfirst.,@n.@n.On @mdate. @mFname. wrote to @mTname....@n.@n.
  786. --------------------------------------------------------------------------
  787.  
  788.   Greeting template for reply.
  789.  
  790. REPLY_4_USENET=In article @Message_ID.,@n.@author. wrote:@n.@n.
  791. ---------------------------------------------------------------
  792.  
  793.   Greeting template for reply post in USENET(SOUP mode).
  794.  
  795. SIGNOFF_INTERNET=Regards,@n.@n.@First.@n.@internet.@n.@n.
  796. ---------------------------------------------------------
  797.  
  798.   Sign off template for Internet mail.
  799.  
  800. SIGNOFF_FIDO=Rgds,@n.@n.-=@First.=-@n.@n.
  801. -----------------------------------------
  802.  
  803.   Sign off template for fidonet/bbs mail.
  804.  
  805. SWAP_ON_EDIT=yes
  806. SWAP_ON_SHELL=no
  807. SWAP_ON_ARCHIVE=yes
  808. SWAP_ON_SPELL=no
  809. -------------------
  810.  
  811.   Swap wsOMR to EMS/XMS/Disk when executing the respective commands?
  812.  
  813. USE_DEL_AS_ESC=yes
  814. ------------------
  815.  
  816.   Use Del key as Esc key when browsing? (only right hand is needed)
  817.  
  818. SET_KEYBOARD_FAST=yes
  819. ---------------------
  820.  
  821.   Ok to set keyboard typematic rate?
  822.  
  823. DELETE_EMPTY_PACKET=yes
  824. -----------------------
  825.  
  826.   Delete empty packets after reading?
  827.  
  828. LIST_EMPTY_AREA=no
  829. ------------------
  830.  
  831.   Include empty areas in the area list screen ?
  832.  
  833. SORT_ADDRESS=yes
  834. ----------------
  835.  
  836.   Sort address book ?
  837.  
  838. DISABLE_TAGLINE=no
  839. ------------------
  840.  
  841.   Disable the appending of tagline to message?
  842.  
  843. TAGLINE_HIGHBIT=no
  844. ------------------
  845.  
  846.   Allow highbit in taglines ?
  847.  
  848. TAGLINE_RANDOM=yes
  849. ------------------
  850.  
  851.   Random selection of tagline ?
  852.  
  853. IS_RE_4_REPLY=no
  854. ----------------
  855.  
  856.   Prefix subj. line with "RE:" when reply( always YES for Internet )
  857.  
  858. SHOW_KLUDGES=no
  859. ---------------
  860.  
  861.   Show control information(kludges) in the message( like MSGID, REPLY,
  862.   PID, PATH etc.,  also SEEN-BY lines, or header of RFC822 message)
  863.  
  864. MESSAGE_LIST_ORDER=2
  865. --------------------
  866.  
  867.   Order to list incoming messages,
  868.   0 - By sender, 1 - by recipient, 2 - by subject, 3 - by order received.
  869.  
  870. USE_BOOKMARK=no
  871. ---------------
  872.  
  873.   Append book mark file (.XTI) to the packet after reading?
  874.  
  875. QWK_EXPERT_MODE=yes
  876. -------------------
  877.  
  878.   if yes, no "E) echo mail, N) net mail, I) internet, Q) quit" question
  879.  
  880. IS_REDIRECT=yes
  881. ---------------
  882.  
  883.   Redirect external program's output?
  884.  
  885. PAGE_LEN=58
  886. -----------
  887.  
  888.   Page length used in printing
  889.  
  890. Netmail_Kill_Sent=yes
  891.  
  892. ; Entries in this section is applicable to Fidonet mode only
  893. ; Change this if you have a different UUCP address
  894.  
  895. [INTERNET_GATEWAY]
  896.  
  897. To=UUCP
  898. Address=1:105/42
  899. ----------------
  900.  
  901. ; Entries in this section is applicable to Internet mode only
  902.  
  903. [INTERNET]
  904.  
  905. APPEND_FROM_LINE=yes
  906. ---------------------
  907.  
  908.   Append the "from: " line to Internet/usenet message, it uses Name & Internet
  909.   entries to form the from line, better leave this to NO unless extremely
  910.   necessary!
  911.  
  912. [MESSAGE_COLOR]
  913.  
  914. hdr_frame=26
  915. hdr_text=27
  916. msg_quote=23
  917. msg_initial=30
  918. msg_initial_spc=26
  919. msg_tagline=27
  920. msg_origin=63
  921. msg_tearline=31
  922. msg_text=31
  923. ;Message reader kludges (controlinfo like MSGID and SEEN-BY):
  924. msg_kludge=3
  925. main_color=3
  926.  
  927.   ; Color for message viewer
  928.  
  929. [LOGO]
  930. curtain=░
  931.  
  932.  
  933. ==========================================================================
  934. ^DISCLAIMER
  935. ░░░░░░░░░░
  936.  
  937.   This program is provided as is.  You may use it at your own risk.
  938.   There is no warranty of any kind or form, explicit or implied,
  939.   covering this program.  The author should in no way be held liable
  940.   for any damage of any form in connection with the use or the
  941.   quality of this program and any of its associated files.
  942. ==========================================================================
  943.  
  944. ^COPYRIGHT & TRADEMARKS
  945. ░░░░░░░░░░░░░░░░░░░░░░
  946.  
  947.   Simple Offline USENET Packet Format (SOUP) Version 1.2
  948.   Copyright (c) 1992-1993 Rhys Weatherley
  949.   rhys@cs.uq.oz.au Last Update: 14 August 1993
  950.  
  951.   wsOMR is copyrighted by Frank Wang.
  952.  
  953.   Eudora is a registered trademark of the University of Illinois Board of
  954.   Trustees, licensed to QUALCOMM Incorporated.
  955.  
  956.   QUALCOMM is a registered trademark and registered service mark of QUALCOMM
  957.   Incorporated.
  958.  
  959.   PINE is a trademark of the University of Washington.
  960.  
  961.   The Blue Wave Packet Structures is copyrighted by George Hatchew and
  962.   Cutting Edge Computing.
  963.  
  964.   mpack/munpack version 1.5 for dos
  965.   (C) Copyright 1993,1994 by Carnegie Mellon University
  966.   All Rights Reserved.( please refer to mime.dos for more details )
  967.  
  968.   OMX is copyrighted by SysTech & Martin Pollard.
  969.   The QWK-format is copyrighted by Sparkware.
  970.  
  971.   PKZIP  -  PKWARE Inc.
  972.   ARC    -  System Enhancement Associates
  973.   LHA    -  Haruyasu Yoshizaki
  974.   PAK    -  NoGate Consulting
  975.   ARJ    -  Robert K Jung
  976.   UC2    -  AIP-NL.
  977.   RAR    -  Eugene Roshal
  978.  
  979.   All program names mentioned in this package are either copyright
  980.   or trademark of respective owners.
  981.  
  982.   wsOMR uses Thomas Wagner's public domain software EXEC library.
  983.  
  984. =============================================================================
  985. ^COMMENTS, SUGGESTIONS & CONTACTING AUTHOR
  986. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  987.  
  988.   All your comments and suggestions are welcome.  Enhancements to
  989.   wsOMR are the result of suggestions and comments made by users. It
  990.   is surely going to grow according to YOUR wishes and requests.
  991.   (Your wish is my command<s>).
  992.  
  993.   You can reach me by:
  994.  
  995.   E-mail           : wang@durian.usc.edu.ph
  996.   Discussion Group : wsomr-l@gigo.com
  997.   ( Listserv for wsOMR, please check read.me for subscribing procedures )
  998.  
  999.   USENET : comp.os.msdos.mail-news
  1000.            alt.usenet.offline-reader
  1001.  
  1002.   FIDONET: OFFLINE, BLUEWAVE, INTERNET
  1003.   RIME   : OFFLINE, INTERNET
  1004.  
  1005.   All your mails are guaranteed to be read, 99% to be answered. :-)
  1006.  
  1007. ==========================================================================
  1008. ^DISTRIBUTION
  1009. ░░░░░░░░░░░░
  1010.  
  1011.   Please feel free to distribute wsOMR to your friends or clients.
  1012.  
  1013.   Redistribution of wsOMR must include the software, its
  1014.   documentation file, order form and all supplemental files (see
  1015.   Files List) as a single unit without any modification.
  1016.  
  1017.   Internet FTP sites:
  1018.  
  1019.     oak.oakland.edu       /SimTel/msdos/offline
  1020.  
  1021.   Fidonet(BBS):
  1022.  
  1023.   U.S.A.
  1024.  
  1025.   The Lunatic Fringe BBS
  1026.   Dane Beko <dbeko@PrimeNet.Com> - Cosysop
  1027.   1-214-235-5288
  1028.   HST 16.8 v32bis Dual/Standard
  1029.   Richardson, Texas
  1030.   Fido:1:124/2113
  1031.   first time callers can DL after filling out a short questionnaire
  1032.  
  1033.   The Catalina BBS
  1034.   Ryan Brown, SysOp (postmaster@catalina.org)
  1035.   Node 1: +1-805-687-1185 1:206/2711@FidoNet.org ZyXEL 19.2k, v.32b 14.4k
  1036.   Node 2: +1-805-687-7220 1:206/2712@FidoNet.org PPI v.FC 28.8k, v.32b 14.4k
  1037.  
  1038.   Just send a FidoNet NetMail with the FREQ flag turned on and with the
  1039.   subject of: WSOMR*.ZIP to 1:206/2711 or 1:206/2712 and it will send
  1040.   back whatever the latest version of wsOMR available in the bbs.
  1041.  
  1042.   CANADA
  1043.  
  1044.   The Edge
  1045.  
  1046.   Craig Hackl <tdr129@duke.usask.ca> - Sysop
  1047.   1-306-382-7049 (Supra 14.4)
  1048.   1-306-382-7039 (USR Sportster 14.4)
  1049.   1-306-382-7038 (PCLogic 14.4)
  1050.   Saskatoon,Saskatchewan
  1051.   Fido 1:140/122 (Usr line)
  1052.   Ld callers can login as Dist Site  there is immediate access to the program
  1053.  
  1054.   Philippines - Cebu City
  1055.  
  1056.   C.E.B.U.        24Hrs
  1057.   63-32-313-797
  1058.   63-32-312-259
  1059.   Jojo Wan - Sysop
  1060.   Cebu, Philippines
  1061.   Fido:6:754/1
  1062.  
  1063.   Philippines - Manila
  1064.  
  1065.   TWiLiGHT ZoNe ! 24Hrs
  1066.   Carlos Legaspi - Sysop
  1067.   63-2-712-0329
  1068.   Manila, Philippines
  1069.   Fido: 6:750/2
  1070.   Available For File Request  Use magic word WSOMR
  1071.  
  1072.   Note: there are some other ftp sites and BBSes carrying this
  1073.         program too, a more updated list will be provided in the
  1074.         future version.
  1075.  
  1076.   To SysOps: please e-mail wang@durian.usc.edu.ph or 6:754/1.20 your
  1077.              BBS info if you are carrying this program, it will be
  1078.              included in the upcoming version.
  1079.  
  1080. ==========================================================================
  1081. ^Thanks!!!
  1082. ░░░░░░░░░
  1083.  
  1084.   This program would never be there in Cyberspace without the
  1085.   following persons, Thanks to:
  1086.  
  1087.   Rhys Weatherley, whose SOUP specification made offline reading of
  1088.   USENET possible, and for his advice which was a tremendous help to
  1089.   the writing of this program.
  1090.  
  1091.   Steve Belczyk, author of the famous UQWK, always around in the net
  1092.   whenever I need his help.
  1093.  
  1094.   Kelsey Hartigan Go, whose support made USENET support in wsOMR a
  1095.   reality.
  1096.  
  1097.   Dane Beko, for his ideas...
  1098.  
  1099.   Roman Roger Kintanar, for his help...
  1100.  
  1101.   Jim Ayson, for his encouragement...
  1102.  
  1103.   Tiago Umm Pascoal, 'The Unstoppable Mail Machine'.
  1104.  
  1105.   Mike Schmeisser, a PITA;-)
  1106.  
  1107.   Rey Estrada, rings me up in the morning, surfing the net for
  1108.   information...
  1109.  
  1110.   Jojo Sybico, who brought BBSing to Cebu, an island in the Pacific
  1111.   Ocean,
  1112.  
  1113.   Do I miss somebody? there are too many people involved in this
  1114.   small undertaking, can't list them all here:(.
  1115.  
  1116. ───────────────────────────────────────────────────────────────────
  1117.  
  1118.   I would like to extend my deepest gratitude to the members of the
  1119.   ^wsOMR beta testing team^ for their tireless efforts in the develop-
  1120.   ment and support of wsOMR.  Their superb testing and innovative
  1121.   suggestions have helped me make wsOMR what it is today...The Most
  1122.   Compact Off-Line Mail Reader in Cyberspace!!
  1123.  
  1124.   Mike Schmeisser
  1125.   Rey Estrada
  1126.   Lee J. Verallo - Tagline Author
  1127.   Michael James Kaamino
  1128.   Jeffrey Shelton
  1129.   Jude Ambrocio P. Dosado
  1130.   Bernie Pangilinan
  1131.   Mario Briones
  1132.   Ferdinand Yap Buzon
  1133.   Joy Sy
  1134.   Jojo Wan
  1135.   Ryan Chiu
  1136.   Roselito delos Reyes
  1137.   Carlos Antonio C. Alejandro
  1138.   Albert Lee
  1139.   Tiago Pascoal
  1140.   Dong Secuya
  1141.   Benson Jao
  1142.   Pat Gibney  - QWK expert
  1143.   Reed Darsey - PGP expert
  1144.   Steve Lapommeray
  1145. 
  1146.